<!DOCTYPE html>
<html lang="en">
<head>
	<meta charset="UTF-8">
	<meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1">
	<title>Start basic API | ElasticSearch 7.7 权威指南中文版</title>
	<meta name="keywords" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <meta name="description" content="ElasticSearch 权威指南中文版, elasticsearch 7, es7, 实时数据分析，实时数据检索" />
    <!-- Give IE8 a fighting chance -->
    <!--[if lt IE 9]>
    <script src="https://oss.maxcdn.com/html5shiv/3.7.2/html5shiv.min.js"></script>
    <script src="https://oss.maxcdn.com/respond/1.4.2/respond.min.js"></script>
    <![endif]-->
	<link rel="stylesheet" type="text/css" href="../static/styles.css" />
	<script>
	var _link = 'start-basic.html';
    </script>
</head>
<body>
<div class="main-container">
    <section id="content">
        <div class="content-wrapper">
            <section id="guide" lang="zh_cn">
                <div class="container">
                    <div class="row">
                        <div class="col-xs-12 col-sm-8 col-md-8 guide-section">
                            <div style="color:gray; word-break: break-all; font-size:12px;">原英文版地址: <a href="https://www.elastic.co/guide/en/elasticsearch/reference/7.7/start-basic.html" rel="nofollow" target="_blank">https://www.elastic.co/guide/en/elasticsearch/reference/7.7/start-basic.html</a>, 原文档版权归 www.elastic.co 所有<br/>本地英文版地址: <a href="../en/start-basic.html" rel="nofollow" target="_blank">../en/start-basic.html</a></div>
                        <!-- start body -->
                  <div class="page_header">
<strong>重要</strong>: 此版本不会发布额外的bug修复或文档更新。最新信息请参考 <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html" rel="nofollow">当前版本文档</a>。
</div>
<div id="content">
<div class="breadcrumbs">
<span class="breadcrumb-link"><a href="index.html">Elasticsearch Guide [7.7]</a></span>
»
<span class="breadcrumb-link"><a href="rest-apis.html">REST APIs</a></span>
»
<span class="breadcrumb-link"><a href="licensing-apis.html">Licensing APIs</a></span>
»
<span class="breadcrumb-node">Start basic API</span>
</div>
<div class="navheader">
<span class="prev">
<a href="get-basic-status.html">« Get basic status API</a>
</span>
<span class="next">
<a href="update-license.html">Update license API »</a>
</span>
</div>
<div class="section xpack">
<div class="titlepage"><div><div>
<h2 class="title">
<a id="start-basic"></a>Start basic API<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/licensing/start-basic.asciidoc">edit</a><a class="xpack_tag" href="https://www.elastic.co/subscriptions"></a>
</h2>
</div></div></div>

<p>This API starts an indefinite basic license.</p>
<h4>
<a id="_request_7"></a>Request<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/licensing/start-basic.asciidoc">edit</a>
</h4>
<p><code class="literal">POST /_license/start_basic</code></p>
<h4>
<a id="_description_17"></a>Description<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/licensing/start-basic.asciidoc">edit</a>
</h4>
<p>The <code class="literal">start basic</code> API enables you to initiate an indefinite basic license, which
gives access to all the basic features. If the basic license does not support
all of the features that are available with your current license, however, you are
notified in the response.  You must then re-submit the API request with the
<code class="literal">acknowledge</code> parameter set to <code class="literal">true</code>.</p>
<p>To check the status of your basic license, use the following API:
<a class="xref" href="get-basic-status.html" title="Get basic status API">Get basic status</a>.</p>
<p>For more information about the different types of licenses, see
<a href="https://www.elastic.co/subscriptions" class="ulink" target="_top">https://www.elastic.co/subscriptions</a>.</p>
<div class="section">
<div class="titlepage"><div><div>
<h3 class="title">
<a id="_authorization_6"></a>Authorization<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/licensing/start-basic.asciidoc">edit</a>
</h3>
</div></div></div>
<p>You must have <code class="literal">manage</code> cluster privileges to use this API.
For more information, see
<a class="xref" href="security-privileges.html" title="Security privileges">Security privileges</a>.</p>
<h4>
<a id="_examples_20"></a>Examples<a class="edit_me edit_me_private" rel="nofollow" title="Editing on GitHub is available to Elastic" href="https://github.com/elastic/elasticsearch/edit/7.7/docs/reference/licensing/start-basic.asciidoc">edit</a>
</h4>
<p>The following example starts a basic license if you do not currently have a license:</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">POST /_license/start_basic</pre>
</div>
<div class="console_widget" data-snippet="snippets/1792.console"></div>
<p>Example response:</p>
<div class="pre_wrapper lang-js">
<pre class="programlisting prettyprint lang-js">{
  "basic_was_started": true,
  "acknowledged": true
}</pre>
</div>
<p>The following example starts a basic license if you currently have a license with more
features than a basic license. As you are losing features, you must pass the acknowledge
parameter:</p>
<div class="pre_wrapper lang-console">
<pre class="programlisting prettyprint lang-console">POST /_license/start_basic?acknowledge=true</pre>
</div>
<div class="console_widget" data-snippet="snippets/1793.console"></div>
<p>Example response:</p>
<div class="pre_wrapper lang-js">
<pre class="programlisting prettyprint lang-js">{
  "basic_was_started": true,
  "acknowledged": true
}</pre>
</div>
</div>

</div>
<div class="navfooter">
<span class="prev">
<a href="get-basic-status.html">« Get basic status API</a>
</span>
<span class="next">
<a href="update-license.html">Update license API »</a>
</span>
</div>
</div>

                  <!-- end body -->
                        </div>
                        <div class="col-xs-12 col-sm-4 col-md-4" id="right_col">
                        
                        </div>
                    </div>
                </div>
            </section>
        </div>
    </section>
</div>
<script src="../static/cn.js"></script>
</body>
</html>